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Abstract 


This EIP introduces a new Simple Serialize (SSZ) type to represent Optional[T] values. 


Motivation 


Optional values are currently only representable in SSZ using workarounds. Adding 
proper support provides these benefits: 


1. Better readability: SSZ structures with optional values can be represented 
with ideomatic types of the underlying programming language, e.g. 
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Optional[T] in Python, making them easier to interact with. 
2. Compact serialization: SSZ serialization can rely on the binary nature of 
optional values; they either exist or they don't. This allows more compact 
serialization than using alternative approaches based on workarounds. 


Specification 
The key words “MUST", “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT", “SHOULD”, 


“SHOULD NOT", “RECOMMENDED”, “NOT RECOMMENDED", “MAY”, and “OPTIONAL” 
in this document are to be interpreted as described in RFC 2119 and RFC 8174. 


Type definition 
Optional[T] is defined as a type that can represent: 


e A value of SSZ type T 
e Absence of a value, indicated by None 


Default value 


The default value of Optional[T] iS None. 


Serialization 


if value is None: 
return b"" 
else: 
return b"\x@1" + serialize(value) 


Deserialization 


The deserialization of an Optional[tT] depends on the input length: 


e If the input length is 0, the value is None . 
e Otherwise, the first byte of the deserialization scope must be checked to be 
exe1 , the remainder of the scope is deserialized same as T. 


Merkleization 


An Optional[T] is merkleized asa List[T, 1]. 


e If the value is None , the list lengthis o. 
e Otherwise, the list length is 1, and the first list element contains the 
underlying value. 


Rationale 
Why not Union[None, T]? 
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Union[None, T] leaves ambiguity about the intention whether the type may be 
extended in the future, i.e. Union[None, T, U]. 


Furthermore, SSZ Union types are currently not used in any final Ethereum 
specification and do not have a finalized design themselves. If the only use case is a 
workaround for lack of Optional[T] , the simpler Optional[T] type is sufficient, and 
support for general unions could be delayed until really needed. Note that the design 
of Optional[T] could be used as basis for a more general union. 


Why not List[T, 1]? 


The serialization is less compact for variable-length T , due to the extra offset table 
at the beginning of the list to indicate the list length. 


Backwards Compatibility 


Union[None, T] and List[T, 1] workarounds are not used at this time to represent 
Optional[T] . 


Test Cases 


See EIP assets. 


Reference Implementation 


e Python: See EIP assets, based on protolambda/remerkleable 


e Nim: status-im/nim-ssz-serialization 


Security Considerations 


None 

Copyright 

Copyright and related rights waived via CCO. 
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